# Create a new group rule

Creates a new rule for the specified group. Requires GroupSettings.Manage permission. The rule will be assigned a unique ID and added to the group's rule list. Rules are used to establish community guidelines and expected behavior. An audit log entry is created for this action.

RBAC: requires GroupSettings.Manage

Endpoint: POST /api/v1/groups/{groupId}/rules
Version: 1.0
Security: header

## Path parameters:

  - `groupId` (string, required)
    The unique identifier of the group to add the rule to
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Query parameters:

  - `hint` (string, required)
    Additional explanation or context for the rule (max 500 characters)
    Example: "This includes no personal attacks, harassment, or discriminatory language"

  - `ordering` (integer, required)
    Display order for the rule (lower values appear first)
    Example: 1000

  - `text` (string, required)
    The rule text that members must follow (max 500 characters)
    Example: "Be respectful to all members"

## Response 200 fields (application/json):

  - `text` (string, required)
    The rule text that defines expected behavior or policy (max 500 characters)
    Example: "Be respectful to all members"

  - `hint` (string, required)
    Additional context or clarification for the rule (max 500 characters)
    Example: "This includes no harassment, personal attacks, or discriminatory language"

  - `ordering` (integer, required)
    Display order position - rules with lower values appear first
    Example: 1000

  - `id` (string, required)
    Unique identifier for the rule
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation